home *** CD-ROM | disk | FTP | other *** search
-
- Update information for BB-ZMODEM v0.61 beta released on 30 Jul 1996
- """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
-
- * Debugging log is only turned on now when Debug is used, the
- last version did log heavy Zmodem transfer information.
-
- [ Documentation for BB-ZMODEM v0.60 beta ]
- """"""""""""""""""""""""""""""""""""""""""
-
- Hi Guys,
-
- Here's a simple Zmodem transfer protocol which you can use with a lot
- programms they doesn't have it. It's not complete but should be good
- enough to work fine in practice. Understand that this programm has
- not been tested by many users but don't be affraid to try it out.
-
- The basic of this Zmodem transfer module (it does only support the
- ZMODEM!) is based on the sources from BinkleyTerm ST written by
- Bit Bucket Software, i have only written the shell around it and
- modified the most code to be usable as stand-alone Zmodem.
-
- My thanks to these people and to all the other people they did heavy
- work on the Atari ST computers and BinkleyTerm including SteVen Green,
- Joerg Spilker, Uwe Zerbe, Stephan Slabihoud, Helmut Neumann, Michael
- Ziegler (GEM SZRZ!) and Bill Scull who is currently active with BT.
-
- I would also thank Jan Kriesten for his serial I/O functions, this
- Zmodem module (i call it BB-Zmodem) does make use of these functions.
-
- If you all read this you will understand why i can't say that i did
- write this programm, i only did have heavy work to get them working
- and stripped from BinkleyTerm ST and add the shell about it and add
- the GEM/TOS environment possibility.
-
- You must understand that i didn't write it to be better then GEM SZRZ,
- if you use that programm then you should not use BB-Zmodem because
- GSZRZ is much much better in practice then this, i know it.
-
- What are the features of this BB-Zmodem transfer protocol?
-
- - It's ofcourse FREE-WARE, do never ask money for it.
- - Raw VT52 terminal build-in
- - Possible to run as TOS and GEM application, different interfaces!
- - Supports some errorlevels
- - Usable for the Octopus Bulletin Board System
-
- Here's a short help...
-
- - Enter '-h or -?' as arguments for command list or nothing to jump in
- raw terminal mode.
-
- - Rename this file to BBZMODEM.TOS or BBZMODEM.TTP to use the TOS interface\n"
- instead of GEM (BBZMODEM.APP, BBZMODEM.GTP or BBZMODEM.PRG)
-
- - Keys available in terminal mode:
-
- Ctrl-B Enter new baudrate
- Ctrl-D Download files
- Ctrl-P Select another modem port
- Ctrl-U Upload a file
- Help Display the help text
- Undo Quit BB-Zmodem terminal
-
- - Other arguments
-
- Usage: bbzmodem <one or more of the following arguments>
-
- - general arguments:
-
- -b <baudrate> (otherwise current baudrate)
- -d Enable debugging log (default turned off)
- -l <name of alternative logfile>
- -p <port> (see bottom list for ports & speeds)
- -q enable quiet mode (less screen output, only in TOS environment)
- -t <time in seconds left> (usable for BBS\'es)
-
- -sz <file> <file> ...
-
- (arguments only usable for sending file(s))
-
- -s <ascii list of files>
- -8 (use 8192 bytes blocks, be sure remote can handle it)
- -w <ascii list of correctly transfered files> (default BBZMODEM.LST)
-
- -rz <pathname>\
-
- (no other special receive arguments)
-
- - errorlevels:
-
- 0 - everything okay
- 1 - carrier lost
- 2 - usertime up
- 3 - transfer aborted by escape
- 4 - lack of disk space
- 5 - general error
- 6 - not enough memory
-
- errorlevels -1 and -2 are removed because they'll threat
- Mag!C with an alert box and stop the system.
-
- That's it! You should when you use it as module from another programm
- specify what modem port must be used, the baudrate is optional and not
- changed when not specified.
-
- To send a few files (available in a filelist) you can use:
-
- BBZMODEM -sz -s filelist -p modem2
-
- (or -p MODEM1, MODEM2, SERIAL1, SERIAL2, MIDI)
-
- To receive to the C:\DOWNLOAD\ path you can use:
-
- BBZMODEM -rz c:\download\
-
- The carrier is allways checked when the modem port does support it, i
- advice to use HSMODEM or FASTSERIAL because it does increase the speed
- a lot in practice.
-
- If you don't know the baudrate what they are supported on the modem port
- you are using then you should enter a wrong baudrate, if you run in TOS
- environment you'll get a list of possible baudrates on your screen of in
- the logfile when running as GEM application (default BBZMODEM.LOG).
-
- Okay! I'm at the end of a summary documentation file for this programm,
- when you use it and it does not work as it should do or you have ideas
- or (not too much critique) then you can contact me on one of the following
- addressed:
-
- Koos Kuil FidoNet 2:282/397 NeST 90:500/103
- AtariNet 51:1001/104 FAN 190:100/204
- E-mail: koos_kuil@nextjk.stuyts.nl
- BBS: +31-597-618087
-
- Remember... i'm not responsible for data damage or something else, if
- it doesn't work what you expect from it then you shouldn't use it.
-
- Oh yes! If you use Octopus then you need the following to let it work!
-
- DownloadProtocols
- {
- Z Zmodem 0 Batch c:\octopus\system\filelist c:\octopus\bbzmodem.gtp "-sz -p modem1 -s c:\octopus\system\filelist "
- }
-
- and....
-
- UploadProtocols
- {
- Z Zmodem Batch c:\octopus\bbzmodem.gtp "-rz c:\octopus\online\ -p modem1 "
- }
-
- *** End ***